作废用户会员卡
将用户的会员卡设置为失效状态。注意：1.设置卡券作废的操作不可逆，即无法将设置为作废的卡调回有效状态，商家须慎重调用该接口。2.商家调用作废接口前须与顾客事先告知并取得同意，否则因此带来的顾客投诉，微信将会按照《微信运营处罚规则》
| 请求参数 | 类型 | 描述 |
|---|---|---|
| user_card_code | string | 会员卡code |
| json | object | 声明请求的JSON数据结构 |
| openid | string | 用户标识 |
| invalid_reason | string | 作废原因 |
| query | object | 声明请求的查询参数 |
| brand_id | string | 品牌id |
| card_id | string | 会员卡模版ID |
php
$instance->v3->brand->partner->cardMember->userCards->_user_card_code_->invalidate->postAsync([
'user_card_code' => '478515832665',
'json' => [
'openid' => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
'invalid_reason' => '传入的自定义作废原因',
],
'query' => [
'brand_id' => '1004',
'card_id' => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(json_decode((string) $response->getBody(), true));
})
->wait();php
$instance->chain('v3/brand/partner/card-member/user-cards/{user_card_code}/invalidate')->postAsync([
'user_card_code' => '478515832665',
'json' => [
'openid' => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
'invalid_reason' => '传入的自定义作废原因',
],
'query' => [
'brand_id' => '1004',
'card_id' => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(json_decode((string) $response->getBody(), true));
})
->wait();php
$instance['v3/brand/partner/card-member/user-cards/{user_card_code}/invalidate']->postAsync([
'user_card_code' => '478515832665',
'json' => [
'openid' => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
'invalid_reason' => '传入的自定义作废原因',
],
'query' => [
'brand_id' => '1004',
'card_id' => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(json_decode((string) $response->getBody(), true));
})
->wait();php
$response = $instance->v3->brand->partner->cardMember->userCards->_user_card_code_->invalidate->post([
'user_card_code' => '478515832665',
'json' => [
'openid' => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
'invalid_reason' => '传入的自定义作废原因',
],
'query' => [
'brand_id' => '1004',
'card_id' => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
],
]);
print_r(json_decode((string) $response->getBody(), true));php
$response = $instance->chain('v3/brand/partner/card-member/user-cards/{user_card_code}/invalidate')->post([
'user_card_code' => '478515832665',
'json' => [
'openid' => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
'invalid_reason' => '传入的自定义作废原因',
],
'query' => [
'brand_id' => '1004',
'card_id' => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
],
]);
print_r(json_decode((string) $response->getBody(), true));php
$response = $instance['v3/brand/partner/card-member/user-cards/{user_card_code}/invalidate']->post([
'user_card_code' => '478515832665',
'json' => [
'openid' => 'obLatjnx9gnqzS4myYGmLZ7LgLBA',
'invalid_reason' => '传入的自定义作废原因',
],
'query' => [
'brand_id' => '1004',
'card_id' => 'pbLatjvWOibDc5-TBnbUk1pD12o0',
],
]);
print_r(json_decode((string) $response->getBody(), true));| 返回字典 | 类型 | 描述 |
|---|---|---|
| user_card_code | string | 会员卡code |
| card_id | string | 会员卡模板ID |
| openid | string | 用户标识 |
| card_color | string | 卡背景颜色 |
| card_picture_url | string | 卡背景图URL |
| brand_id | string | 品牌ID |
| card_type | string | 会员卡类型PURCHASE | NORMAL | BALANCE 枚举值之一 |
| phone_number | string | 加密的手机号 |
| level | string | 等级 |
| valid_date_information | object | 会员卡有效期 |
| type | string | 有效期类型FIX_TIME_RANGE | FIX_TERM | PERMANENT 枚举值之一 |
| available_begin_time | string | 有效期开始时间 |
| available_end_time | string | 有效期结束时间 |
| available_day_after_receive | integer | 生效后N天内有效 |
| pickup_time | string | 领取时间 |
| user_information | object | 用户开卡时填写的个人信息 |
| common_field_list | object[] | 平台提供的通用开卡信息字段 |
| name | string | 平台提供的通用开卡信息字段USER_FORM_FLAG_SEX | USER_FORM_FLAG_NAME | USER_FORM_FLAG_BIRTHDAY | USER_FORM_FLAG_ADDRESS | USER_FORM_FLAG_EMAIL | USER_FORM_FLAG_CITY 枚举值之一 |
| value | string | 加密的用户开卡时填写的个人信息 |
| custom_field_list | object[] | 商户自定义的开卡信息字段 |
| name | string | 字段名称 |
| user_chosen_values | string[] | 加密的用户选择的字段值列表 |
| attach | string | 商家数据包 |
| user_card_state | string | 用户会员卡状态UNACTIVATED | EFFECTIVE | EXPIRED | INVALID 枚举值之一 |
| invalid_reason | string | 作废原因 |
| invalid_time | string | 作废时间 |